home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / mediad.z / mediad
Encoding:
Text File  |  2001-04-17  |  20.9 KB  |  397 lines
  1.  
  2.  
  3.  
  4. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mediad - removable media daemon
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmeeeeddddiiiiaaaadddd
  13.      mmmmeeeeddddiiiiaaaadddd [ ----llll _l_e_v_e_l ] [ ----ffff ] ] [ ----nnnn ] ----aaaa
  14.      mmmmeeeeddddiiiiaaaadddd [ ----dddd ] ----ffff
  15.      mmmmeeeeddddiiiiaaaadddd ----kkkk
  16.      mmmmeeeeddddiiiiaaaadddd ----llll _l_e_v_e_l
  17.      mmmmeeeeddddiiiiaaaadddd [ ----llll _l_e_v_e_l ] ----eeee [ _c_t_l_r ] _I_D [ _L_U_N ] | _d_i_r | _d_e_v_i_c_e
  18.      mmmmeeeeddddiiiiaaaadddd [ ----llll _l_e_v_e_l ] ----uuuu
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      mmmmeeeeddddiiiiaaaadddd is a daemon that monitors the removable media devices on a system.
  22.      When media is inserted, mediad scans the media for filesystems and mounts
  23.      them.  When a user issues the eeeejjjjeeeecccctttt command, eeeejjjjeeeecccctttt sends mediad a
  24.      message, and mediad dismounts the filesystems and ejects the media.
  25.      NNNN....BBBB....:::: Because data corruption and loss will occur if media is forcibly
  26.      removed without unmounting any filesystems present on the media, always
  27.      eject disk media using either the eeeejjjjeeeecccctttt command or the _E_j_e_c_t selection in
  28.      the desktop pop-up menu for the device.
  29.  
  30.      For all options other than ----eeee, ----uuuu, and ----mmmm, mediad may only be invoked by
  31.      the superuser.
  32.  
  33.      mmmmeeeeddddiiiiaaaadddd reads configuration options from its configuration file,
  34.      /_e_t_c/_c_o_n_f_i_g/_m_e_d_i_a_d._c_o_n_f_i_g.  mediad continually monitors its configuration
  35.      file.  When that file changes, mediad immediately updates device status
  36.      to match the file.  The configuration file is described below under
  37.      CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX.
  38.  
  39.      mmmmeeeeddddiiiiaaaadddd also provides information to the IRIX Interactive Desktop and
  40.      system administration tools which they use to draw the icons representing
  41.      removable media devices.
  42.  
  43.      mmmmeeeeddddiiiiaaaadddd monitors these device types:
  44.  
  45.        CDROM    CD-ROM
  46.  
  47.        dat      DAT tape
  48.  
  49.        floppy   Insite floptical disk, Teac SCSI floppy disk
  50.  
  51.        jaz      Iomega Jaz disk
  52.  
  53.        LS-120   LS-120 I-O Data 120MB floppy-compatible disk
  54.  
  55.        optical  Sony SMO-521 and Pinnacle Sierra magneto-optical disks
  56.  
  57.        syquest  SyQuest EZ135, 88, 105, 200, and 270 Mb disks
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  71.  
  72.  
  73.  
  74.        tape     QIC 24, 150, 1000, and 1350 tapes, IBM 3480 tape, Exabyte 8 mm
  75.                 tape, and DLT tape
  76.  
  77.        zip      Iomega Zip disk
  78.  
  79.      Note that CDROM, dat, floppy, LS-120 and tape are sold and supported by
  80.      SGI.  The rest (jaz, optical, syquest, zip) are not sold or supported by
  81.      SGI.
  82.  
  83.      mmmmeeeeddddiiiiaaaadddd recognizes these filesystem types on devices that support them.
  84.      See _f_i_l_e_s_y_s_t_e_m_s(4).
  85.  
  86.        cdda     Compact Disk Digital Audio
  87.  
  88.        dos      IBM PC DOS
  89.  
  90.        efs      Silicon Graphics Extent File System
  91.  
  92.        iso9660  ISO 9660 filesystem for CD-ROM, also the High Sierra, Rock
  93.                 Ridge and PhotoCD extensions.
  94.  
  95.        hfs      Apple Macintosh Hierarchical File System
  96.  
  97.        xfs      Silicon Graphics XFS File System
  98.  
  99.      If a disk has several nonoverlapping partitions, mmmmeeeeddddiiiiaaaadddd mounts them all
  100.      by default.  If it has overlapping partitions, mediad mounts the
  101.      filesystem type that appears first in the list above.  You can override
  102.      the default behavior using the configuration file.
  103.  
  104.      mmmmeeeeddddiiiiaaaadddd uses the following rules to choose the directory where it mounts a
  105.      filesystem.
  106.  
  107.      1.   If the configuration file contains an applicable mmmmoooouuuunnnntttt command, and
  108.           the mmmmoooouuuunnnntttt command specifies a directory, that directory is used.
  109.  
  110.      2.   Otherwise, if mediad is only mounting one partition from the device,
  111.           then the device name is used.  If there is more than one device of a
  112.           given type, a number is appended to every device except the first.
  113.           (For example, filesystems from two Zip drives are mounted at /_z_i_p
  114.           and /_z_i_p_2.)
  115.  
  116.      3.   Otherwise, the directory name is made by concatenating the device
  117.           name, the filesystem type, and the partition number.  (For example,
  118.           three DOS partitions on a Jaz drive are mounted at
  119.           /_j_a_z/_d_o_s._p_a_r_t_i_t_i_o_n_1, /_j_a_z/_d_o_s._p_a_r_t_i_t_i_o_n_2 and /_j_a_z/_d_o_s._p_a_r_t_i_t_i_o_n_3.)
  120.  
  121.      mmmmeeeeddddiiiiaaaadddd uses the dynamic shared objects (DSOs) in /_u_s_r/_d_e_v_i_c_e_l_i_b.  There
  122.      is one DSO for each device type mediad understands and one DSO for each
  123.      filesystem type.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  137.  
  138.  
  139.  
  140. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  141.      ----aaaa   Start mediad in the background.  (This is the default when no
  142.           arguments are specified)
  143.  
  144.      ----dddd   Turn on the _d_s_d_e_b_u_g variable of _d_s_l_i_b(3X) which enables voluminous
  145.           SCSI command tracing.  The ----dddd option must be used with the ----ffff
  146.           option.
  147.  
  148.      ----eeee _d_e_v_i_c_e
  149.           Eject the given device.  The device must be specified as described
  150.           under CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX, below.
  151.  
  152.      ----eeee _d_i_r_e_c_t_o_r_y
  153.           Eject the device containing the filesystem mounted at the given
  154.           directory.
  155.  
  156.      ----ffff   Start mediad in the foreground.  When running in the foreground,
  157.           mediad does not fork at startup.  The ----ffff option also sets the
  158.           default log level to LLLLOOOOGGGG____DDDDEEEEBBBBUUUUGGGG, and log messages are directed to
  159.           mediad's standard error instead of to _s_y_s_l_o_g_d(1M).
  160.  
  161.      ----kkkk   Send a message to mediad telling it to exit.  When mediad exits, it
  162.           dismounts all the filesystems it has mounted.
  163.  
  164.      ----llll _l_e_v_e_l
  165.           When used alone, sends a message to the currently running mediad to
  166.           log all messages of priority _l_e_v_e_l and higher.  When used with ----aaaa,
  167.           ----ffff, ----eeee or ----uuuu option, the ----llll option affects the current mediad
  168.           process instead of sending a message.
  169.  
  170.      ----nnnn   Mount all filesystems with the nosuid mount option.  When ----nnnn is
  171.           specified, _n_o_s_u_i_d is specified in the options argument of all
  172.           _m_o_u_n_t(1M) commands that _m_e_d_i_a_d runs.
  173.  
  174.      ----uuuu   Eject the default device.  On systems with more than one removable
  175.           media device, this command should not be used, because the default
  176.           device is not predictable.
  177.  
  178. EEEEXXXXAAAAMMMMPPPPLLLLEEEE CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  179.      mmmmeeeeddddiiiiaaaadddd ----llll 7777 ----aaaa
  180.           Start mediad in the background with full debugging output.
  181.  
  182.      mmmmeeeeddddiiiiaaaadddd ----ffff
  183.           Start mediad in the foreground with full debugging output.
  184.  
  185.      mmmmeeeeddddiiiiaaaadddd ----eeee 0000 4444 0000
  186.      mmmmeeeeddddiiiiaaaadddd ----eeee 0000 4444
  187.      mmmmeeeeddddiiiiaaaadddd ----eeee 4444
  188.      mmmmeeeeddddiiiiaaaadddd ----eeee ////ddddeeeevvvv////ssssccccssssiiii////sssscccc0000dddd4444llll0000
  189.      mmmmeeeeddddiiiiaaaadddd ----eeee ////ddddeeeevvvv////rrrrddddsssskkkk////ddddkkkkssss0000dddd4444ssss7777
  190.      mmmmeeeeddddiiiiaaaadddd ----eeee ////ddddeeeevvvv////rrrrmmmmtttt////ttttppppssss0000dddd4444
  191.      mmmmeeeeddddiiiiaaaadddd ----eeee ////ddddeeeevvvv////rrrrddddsssskkkk////ffffddddssss0000dddd4444....3333....5555hhhhiiii
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  203.  
  204.  
  205.  
  206.           Each of these commands ejects the device at SCSI controller 0, ID 4,
  207.           LUN 0.
  208.  
  209.      mmmmeeeeddddiiiiaaaadddd ----eeee ////ffffllllooooppppppppyyyy
  210.           Eject the device with a filesystem mounted at the directory /_f_l_o_p_p_y.
  211.  
  212. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX
  213.      mediad's configuration file, /_e_t_c/_c_o_n_f_i_g/_m_e_d_i_a_d._c_o_n_f_i_g, is optional, and
  214.      is not present in the system as shipped.  It may be created at any time
  215.      as needed.  The file consists of one or more configuration commands, with
  216.      one command per line.  Comments begin with a # character and continue to
  217.      the end of the line.
  218.  
  219.      A ddddeeeevvvviiiicccceeee ssssppppeeeecccciiiiffffiiiiccccaaaattttiiiioooonnnn specifies a device.  It consists of the keyword
  220.      ddddeeeevvvviiiicccceeee followed by the name of a device special file.  The special file
  221.      is only used to determine the device's address - the type of device is
  222.      unimportant.  Mediad recognizes these device types.
  223.  
  224.        scsi    generic SCSI device
  225.  
  226.        dksc    SCSI disk device
  227.  
  228.        tpsc    SCSI tape device
  229.  
  230.        smfd    SCSI floppy/floptical device
  231.  
  232.      A ffffiiiilllleeeessssyyyysssstttteeeemmmm ssssppppeeeecccciiiiffffiiiiccccaaaattttiiiioooonnnn specifies a pattern to match filesystems.  A
  233.      filesystem specification consists of the keyword ffffiiiilllleeeessssyyyysssstttteeeemmmm, the name of
  234.      a device special file, a filesystem type, and, optionally, the keyword
  235.      ppppaaaarrrrttttiiiittttiiiioooonnnn followed by a partition number.  If the partition number is
  236.      omitted, the filesystem specification matches a filesystem covering the
  237.      whole disk.  In general, within a filesystem specification the device
  238.      should be named using the device special file name that mediad uses by
  239.      default.  An exception occurs when using ISO 9660 CD-ROMs.  For ISO 9660
  240.      filesystems the CD-ROM device must be specified by its entry in the
  241.      directory /_d_e_v/_s_c_s_i.
  242.  
  243.      These are the configuration file's commands.
  244.  
  245.      iiiiggggnnnnoooorrrreeee _d_e_v_i_c_e _s_p_e_c_i_f_i_c_a_t_i_o_n
  246.           Tells mediad not to monitor this device.  The device will have a
  247.           generic device icon on the desktop, and mediad will not access the
  248.           device.
  249.  
  250.      iiiiggggnnnnoooorrrreeee _f_i_l_e_s_y_s_t_e_m _s_p_e_c_i_f_i_c_a_t_i_o_n
  251.           Tells mediad not to mount filesystems matching this specification.
  252.  
  253.      mmmmoooonnnniiiittttoooorrrr _d_e_v_i_c_e _s_p_e_c_i_f_i_c_a_t_i_o_n
  254.           Tells mediad to monitor this device.  This is the default.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  269.  
  270.  
  271.  
  272.           The monitor command has these optional parameters.
  273.  
  274.           iiiinnnnsssscccchhhhkkkk _n_u_m_b_e_r
  275.                Tells mediad to check for media insertion every _n_u_m_b_e_r seconds.
  276.                The default is 3.
  277.  
  278.           rrrrmmmmvvvvcccchhhhkkkk _n_u_m_b_e_r
  279.                Tells mediad to check for media removal every _n_u_m_b_e_r seconds.
  280.                The default is 45.
  281.  
  282.      mmmmoooouuuunnnntttt _f_i_l_e_s_y_s_t_e_m _s_p_e_c_i_f_i_c_a_t_i_o_n
  283.           Tells mediad to mount filesystems matching this specification.
  284.           Filesystems that match a mount command will be preferentially
  285.           mounted over filesystems that do not, so you can use the mmmmoooouuuunnnntttt
  286.           command to override mediad's filesystem precedence order.
  287.  
  288.           The mount command has these optional parameters.
  289.  
  290.           ddddiiiirrrreeeeccccttttoooorrrryyyy _p_a_t_h
  291.                Tells mediad to mount the filesystem at this directory.
  292.  
  293.           ooooppppttttiiiioooonnnnssss _l_i_s_t
  294.                Tells mediad to pass these mount options to the mount command
  295.                when mounting the filesystem.  See _f_s_t_a_b(4) for a list of valid
  296.                options.
  297.  
  298.           sssshhhhaaaarrrreeeedddd
  299.                Tells mediad to export the filesystem for remote NFS access
  300.                after mounting it.  If the filesystem's mount directory is
  301.                listed in /_e_t_c/_e_x_p_o_r_t_s (see _e_x_p_o_r_t_s(4)), the export options
  302.                listed there are used.  Otherwise, the filesystem is exported
  303.                read-only to all hosts.  See the description of the sssshhhhaaaarrrreeee
  304.                command below.
  305.  
  306.           uuuunnnnsssshhhhaaaarrrreeeedddd
  307.                Tells mediad not to export the filesystem.
  308.  
  309.      sssshhhhaaaarrrreeee _d_e_v_i_c_e _s_p_e_c_i_f_i_c_a_t_i_o_n
  310.           Tells mediad to share the specified device.  A shared device can be
  311.           accessed from other machines through the IRIX Interactive Desktop.
  312.           A shared device's filesystems are also exported by default, although
  313.           you can override that behavior via the mmmmoooouuuunnnntttt command, described
  314.           above.
  315.  
  316. SSSSAAAAMMMMPPPPLLLLEEEE CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE
  317.      #### iiiiggggnnnnoooorrrreeee aaaa ttttaaaappppeeee ddddeeeevvvviiiicccceeee ccccoooommmmpppplllleeeetttteeeellllyyyy....
  318.      iiiiggggnnnnoooorrrreeee ddddeeeevvvviiiicccceeee ////ddddeeeevvvv////rrrrmmmmtttt////ttttppppssss0000dddd6666
  319.  
  320.      #### ddddoooo nnnnooootttt mmmmoooouuuunnnntttt aaaauuuuddddiiiioooo CCCCDDDDssss oooonnnn tttthhhhiiiissss CCCCDDDD----RRRROOOOMMMM ddddrrrriiiivvvveeee....
  321.      iiiiggggnnnnoooorrrreeee ffffiiiilllleeeessssyyyysssstttteeeemmmm ////ddddeeeevvvv////ssssccccssssiiii////sssscccc0000dddd4444llll0000 ccccddddddddaaaa
  322.  
  323.      #### cccchhhheeeecccckkkk aaaa ffffllllooooppppppppyyyy ddddeeeevvvviiiicccceeee ffffoooorrrr iiiinnnnsssseeeerrrrttttiiiioooonnnn aaaannnndddd rrrreeeemmmmoooovvvvaaaallll
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))                                                          MMMMEEEEDDDDIIIIAAAADDDD((((1111MMMM))))
  335.  
  336.  
  337.  
  338.      #### eeeevvvveeeerrrryyyy 66660000 sssseeeeccccoooonnnnddddssss
  339.      mmmmoooonnnniiiittttoooorrrr ddddeeeevvvviiiicccceeee ////ddddeeeevvvv////ssssccccssssiiii////sssscccc0000dddd2222llll0000 iiiinnnnsssscccchhhhkkkk 66660000 rrrrmmmmvvvvcccchhhhkkkk 66660000
  340.  
  341.      #### mmmmoooouuuunnnntttt HHHHFFFFSSSS ((((MMMMaaaacccciiiinnnnttttoooosssshhhh)))) ffffiiiilllleeeessssyyyysssstttteeeemmmmssss oooonnnn aaaa CCCCDDDD----RRRROOOOMMMM
  342.      #### pppprrrreeeeffffeeeerrrreeeennnnttttiiiiaaaallllllllyyyy oooovvvveeeerrrr ooootttthhhheeeerrrr ffffiiiilllleeeessssyyyysssstttteeeemmmm ttttyyyyppppeeeessss
  343.      mmmmoooouuuunnnntttt ffffiiiilllleeeessssyyyysssstttteeeemmmm ////ddddeeeevvvv////ssssccccssssiiii////sssscccc0000dddd4444llll0000 hhhhffffssss
  344.  
  345.      #### mmmmoooouuuunnnntttt EEEEFFFFSSSS ffffiiiilllleeeessssyyyysssstttteeeemmmmssss oooonnnn tttthhhheeee ggggiiiivvvveeeennnn CCCCDDDD----RRRROOOOMMMM aaaatttt
  346.      #### tttthhhheeee ddddiiiirrrreeeeccccttttoooorrrryyyy """"////ddddaaaattttaaaa"""",,,, ddddiiiissssaaaalllllllloooowwwwiiiinnnngggg sssseeeetttt----UUUUIIIIDDDD pppprrrrooooggggrrrraaaammmmssss....
  347.      mmmmoooouuuunnnntttt ffffiiiilllleeeessssyyyysssstttteeeemmmm ////ddddeeeevvvv////ddddsssskkkk////ddddkkkkssss0000dddd4444ssss7777 eeeeffffssss ddddiiiirrrreeeeccccttttoooorrrryyyy ////ddddaaaattttaaaa ooooppppttttiiiioooonnnnssss nnnnoooossssuuuuiiiidddd
  348.  
  349.      #### sssshhhhaaaarrrreeee aaaa ZZZZiiiipppp ddddrrrriiiivvvveeee
  350.      sssshhhhaaaarrrreeee ddddeeeevvvviiiicccceeee ////ddddeeeevvvv////ssssccccssssiiii////sssscccc0000dddd6666llll0000
  351.  
  352.  
  353. FFFFIIIILLLLEEEESSSS
  354.      /etc/config/mediad.config     configuration file
  355.  
  356.      /etc/init.d/mediad            mediad startup and shutdown script
  357.  
  358.      /etc/config/mediad.options    command line arguments mediad is started
  359.                                    with during system initialization
  360.  
  361.      /usr/lib/devicelib/dev_*.so   device DSOs
  362.  
  363.      /usr/lib/devicelib/fmt_*.so   filesystem format DSOs
  364.  
  365. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  366.      eject(1), mount(1M), exports(4), filesystems(4), fstab(4), scsi(7),
  367.      dksc(7), tpsc(7), smfd(7).
  368.  
  369. NNNNOOOOTTTTEEEESSSS
  370.      For a complete list of devices supported on SGI platforms, please contact
  371.      your support provider.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.